Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Editing Movies / Editing Tracks

CopyTrackSettings

The CopyTrackSettings function copies many settings from one track to another, overwriting the destination settings.

pascal OSErr CopyTrackSettings (Track srcTrack, Track dstTrack);

srcTrack

Specifies the source track for this operation. Your application
obtains this track identifier from such Movie Toolbox functions as NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).

dstTrack

Specifies the destination track for this operation. The CopyTrackSettings function uses the settings from the source track, which you specify with the srcTrack parameter, to replace the current settings of this track.

DESCRIPTION

The CopyTrackSettings function copies the

• matrix information
• track volume
• clipping region
• user data
• matte information
• media language, quality, and user data
• other media-specific settings (such as sound balance and video graphics mode)

This function does not copy any alternate group information pertaining to the track.

If you want to work with specific characteristics, you can use the Movie Toolbox functions that allow you to manipulate track settings individually. These functions are described in "Functions That Modify Movie Properties," which begins on page 2-142.

This function does not copy the track's contents. To work with track contents, you should use the segment-editing functions described in "Editing Tracks" beginning on page 2-245.

ERROR CODES

invalidTrack

-2009

This track is corrupted or invalid

Memory Manager errors